MachineDataMake
生成机器数据构造的事务
请求地址
POST
http://OmsAddress/app/newoms.php/webservice/oamp/machine-data/make?cmd=10012&ip-type=webservicerest&access-token=AccessTokenVal
POST请求参数说明
参数名称 | 数据类型 | 说明 | 是否必填字段 | 备注 |
---|---|---|---|---|
set_id | 整型 | 事务所在的集群的id | 是 | |
svrIdList | 数组 | 构造数据的svr列表格式:svr id、ip、 username、 password,用空格隔开,账号密码中不能含有(\ ; - 空格 竖线))如:126.2.2.3 1.1.1.1 tcaplus tcaplus | 是 | |
backType | 整型 | 数据构造类型,1:冷备时间构造,2:精确时间构造 | 是 | |
engineBackupDate | 字符串 | 冷备构造数据日期,格式:xxxx-xx-xx,如2018-03-07 | backType=1时,必填 | |
uLogBackupTime | 字符串 | Ulog构造数据时间点,格式:xxxx-xx-xx xx:xx:xx如2018-03-05 16:00:04 | backType=2时,必填 | |
maxConcurrentActionNum | 整型 | 事务并行度,范围: [1, 50],默认值:10 | 否 |
Data参数
使用json格式表示记录相关信息,示例如下:
{
"setId": 126,
"svrIdList": [
"126.2.2.3 1.1.1.1 tcaplus tcaplus"
],
"engineBackupDate": "2018-03-07",
"backType": 1,
"maxConcurrentActionNum": 10
}
返回语法
返回参数说明
返回状态码不为200时,表示失败,返回数据为构造表数据失败的信息
返回状态码为200,表示表数据构造创建成功,返回的数据结构如下:
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
trans_id | 整型 | 执行的对应的事务的id | |
set_id | 整型 | 事务所在的集群 |
请求示例
通过 curl 方法发起请求
命令中的参数请参考本页中的“POST请求参数说明”,access-token的获取方法详见:获取access-token
curl -H "Content-type: application/json" -X "POST" -d '{
"setId": 126,
"svrIdList": [
"126.2.2.3 1.1.1.1 tcaplus tcaplus"
],
"engineBackupDate": "2018-03-07",
"backType": 1,
"maxConcurrentActionNum": 10
}' http://omsaddress/app/newoms.php/webservice/oamp/machine-data/make?cmd=10012&ip-type=webservicerest&access-token=<access-token>
返回示例
成功返回示例
http请求的Status=200
{
"SetId": "126",
"TransId": 108,
"username": "username"
}
错误返回
http请求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"Error": [
"The Ulog retraction time point must be greater than the cold backup date"
]
}